home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
clipper
/
nftroff.zip
/
1.tr
next >
Wrap
Text File
|
1991-11-21
|
18KB
|
1,123 lines
.de }n
.bp
.sp .5i
..
.wh -.8i }n
.sp .5i
.po -.4i
.ll 7.5i
.ps 9
.vs 9
.in 0i
.ta 1.63265i
.sp 2
.ne 20
.ps +3
.vs +3
FT_AADDITION() Add elements unique of source array to target array
.br
.ta
.in 0.08i
.ps -3
.vs -3
.sp 2
\fBFT_AADDITION()
Add elements unique of source array to target array
.in 0i
.br
\l'6.24i'
.br
.sp
.in 0.08i
\fBSyntax
.sp
.in 0.4i
\fBFT_AADDITION( <aList1>, <aList2> [, <lTrimmer> [, <lCaseSens> ] ] ) ;
.in 1.04i
\fB-> aNewArray
.sp
.in 0.08i
\fBArguments
.sp
.in 0.4i
\fB<aList1>\fR is the primary array\.
.sp
\fB<aList2>\fR is the secondary array\.
.sp
\fB<lTrimmer>\fR is a logical value denoting whether leading or
.in 1.04i
trailing spaces should be included in the
comparison\. If \.T\., then ignores spaces in
comparison, defaults to \.T\., \.F\. includes spaces\.
.sp
.in 0.4i
\fB<lCaseSens>\fR is a logical value denoting case sensitivity\.
.in 1.04i
If \.T\., then comparison is sensitive to case,
defaults to \.T\., \.F\. ignores case\.
.sp
.in 0.08i
\fBReturns
.sp
.in 0.4i
An array of the union of aList1 and aList2\.
.sp
.in 0.08i
\fBDescription
.sp
.in 0.4i
This function will add the elements unique of aList2 with aList1\.
It returns a new array including all the elements of aList1
plus the unique elements of aList2\.
.sp
.in 0.08i
\fBExamples
.sp
.in 0.4i
.br
aList1 := {"apple", "orange", "pear"}
.br
aList2 := {"apple ", "banana", "PEAR"}
.sp
.br
FT_AADDITION( aList1, aList2 )
.in 0.8i
.br
// ignores spaces, sensitive to case
.br
// returns {"apple","orange","pear","banana","PEAR"}
.sp
.in 0.4i
.br
FT_AADDITION( aList1, aList2, , \.F\. )
.in 0.8i
.br
// ignores spaces, not sensitive to case
.br
// returns {"apple","orange","pear","banana"}
.sp
.in 0.4i
.br
FT_AADDITION( aList1, aList2, \.F\., \.F\. )
.in 0.8i
.br
// sensitive to spaces, not sensitive to case
.br
// returns {"apple","orange","pear","apple ","banana"}
.sp
.in 0.08i
\fBSource:\fR AADING\.PRG
.sp
.ta 1.84i
\fBAuthor:\fR Ralph Oliver, TRANSCOM SYSTEMS
.br
.ta
.in 0i
.ta 1.63265i
.sp 2
.ne 20
.ps +3
.vs +3
FT_AAVG() Average numeric values in an array
.br
.ta
.in 0.08i
.ps -3
.vs -3
.sp 2
\fBFT_AAVG()
Average numeric values in an array
.in 0i
.br
\l'6.24i'
.br
.sp
.in 0.08i
\fBSyntax
.sp
.in 0.4i
\fBFT_AAVG( <aArray> [, <nStartIndex> [, <nEndIndex> ] ] ) -> nAverage
.sp
.in 0.08i
\fBArguments
.sp
.in 0.4i
\fB<aArray>\fR is the array containing the elements to be averaged\.
.sp
\fB<nStartIndex>\fR is the first array item to include,
defaults to first element\.
.sp
\fB<nEndIndex>\fR is the last array element to include,
defaults to all elements\.
.sp
.in 0.08i
\fBReturns
.sp
.in 0.4i
The average of the specified array elements\.
.sp
.in 0.08i
\fBDescription
.sp
.in 0.4i
This function is used to get a numeric average of selected or all
elements of an array\.
.sp
This routine requires FT_ASUM()\.
.sp
.in 0.08i
\fBExamples
.sp
.in 0.4i
.ta 2.32i
FT_AAVG(aSubTotals) // Get Average of Entire Array
.br
.ta
.sp
.ta 2.32i
FT_AAVG(aSubTotals, 5) // Get Average of 5th Element On
.br
.ta
.sp
.ta 2.32i
FT_AAVG(aSubTotals, , 10) // Get Average of 1st 10 Elements
.br
.ta
.sp
.ta 2.32i
FT_AAVG(aSubTotals, 5, 10) // Get Average of Elements 5-10
.br
.ta
.sp
.in 0.08i
\fBSource:\fR AAVG\.PRG
.sp
\fBAuthor:\fR David Husnian
.in 0i
.ta 1.63265i
.sp 2
.ne 20
.ps +3
.vs +3
FT_ADESSORT() Sort an array in descending order
.br
.ta
.in 0.08i
.ps -3
.vs -3
.sp 2
\fBFT_ADESSORT()
Sort an array in descending order
.in 0i
.br
\l'6.24i'
.br
.sp
.in 0.08i
\fBSyntax
.sp
.in 0.4i
\fBFT_ADESSORT( <aArray> [, <nStartIndex> [, <nEndIndex> ] ] ) -> aSorted
.sp
.in 0.08i
\fBArguments
.sp
.in 0.4i
\fB<aArray>\fR is the array to be sorted
.sp
\fB<nStartIndex>\fR is the first array item to include in the sort,
defaults to first element
.sp
\fB<nEndIndex>\fR is the last array element to include in the sort,
defaults to all elements
.sp
.in 0.08i
\fBReturns
.sp
.in 0.4i
The array, sorted in descending order\.
.sp
.in 0.08i
\fBDescription
.sp
.in 0.4i
This function is used to sort an array in descending order, i\.e\., Z-A
.sp
.in 0.08i
\fBExamples
.sp
.in 0.4i
.ta 2.72i
FT_ADESSORT(aNames) // Sort the Entire Array
.br
.ta
.sp
.ta 2.72i
FT_ADESSORT(aNames, 5) // Sort from the 5th Element On
.br
.ta
.sp
.ta 2.72i
FT_ADESSORT(aNames, , 10) // Sort the 1st 10 Elements
.br
.ta
.sp
.ta 2.72i
FT_ADESSORT(aNames, 5, 10) // Sort Elements 5-10
.br
.ta
.sp
.in 0.08i
\fBSource:\fR ADESSORT\.PRG
.sp
\fBAuthor:\fR David Husnian
.in 0i
.ta 1.63265i
.sp 2
.ne 20
.ps +3
.vs +3
FT_AEMAXLEN() Find longest element within an array
.br
.ta
.in 0.08i
.ps -3
.vs -3
.sp 2
\fBFT_AEMAXLEN()
Find longest element within an array
.in 0i
.br
\l'6.24i'
.br
.sp
.in 0.08i
\fBSyntax
.sp
.in 0.4i
\fBFT_AEMAXLEN( <aArray> [, <nDimension> [, <nStart> [, <nCount> ] ] ] ) ;
.in 1.28i
\fB-> nMaxlen
.sp
.in 0.08i
\fBArguments
.sp
.in 0.4i
\fB<aArray>\fR is the array containing the elements to be measured\.
.sp
\fB<nDimension>\fR is the array dimension to be measured,
.in 1.28i
defaults to first dimension\.
.sp
.in 0.4i
\fB<nStart>\fR is the starting array element to include,
.in 1.28i
defaults to first array element\.
.sp
.in 0.4i
\fB<nCount>\fR is the number of array elements to process from
.in 1.28i
from \fB<nStart>\fR, defaults to remaining elements
in array\.
.sp
.in 0.08i
\fBReturns
.sp
.in 0.4i
The length of the longest size element of an array\.
.sp
.in 0.08i
\fBDescription
.sp
.in 0.4i
This function will measure each element of an array
dimension and return the longest element\.
.sp
.in 0.08i
\fBExamples
.sp
.in 0.4i
.ta 2.08i
FT_AEMAXLEN(aArray) // Measure the 1st dimension of an Array
.br
.ta
.sp
.ta 2.08i
FT_AEMAXLEN(aArray,2) // Measure the 2nd dimension of an Array
.br
.ta
.sp
.ta 2.08i
FT_AEMAXLEN(aArray,2,,9) // Measure Elements 1-9 of the
.br
.ta
.in 2.96i
2nd dimension or subarray
.sp
.in 0.4i
FT_AEMAXLEN(aArray,3,5,9) // Measure Elements 5-9 of the
.in 2.96i
3rd dimension or subarray
.sp
.in 0.4i
.ta 2.08i
FT_AEMAXLEN(aArray,3,5) // Measure Elements 5 to last in the
.br
.ta
.in 2.96i
3rd dimension or subarray
.sp
.in 0.08i
\fBSource:\fR AEMAXLEN\.PRG
.sp
.ta 1.84i
\fBAuthor:\fR Ralph Oliver, TRANSCOM SYSTEMS
.br
.ta
.in 0i
.sp
.in 1.5i
.ti -1.5i
.ta 1.5i
.ft B
See Also:
.ft R
FT_AEMINLEN()
.ta 1.63265i
.in 0i
.sp 2
.ne 20
.ps +3
.vs +3
FT_AEMINLEN() Find shortest element within an array
.br
.ta
.in 0.08i
.ps -3
.vs -3
.sp 2
\fBFT_AEMINLEN()
Find shortest element within an array
.in 0i
.br
\l'6.24i'
.br
.sp
.in 0.08i
\fBSyntax
.sp
.in 0.4i
\fBFT_AEMINLEN( <aArray> [, <nDimension> [, <nStart> [, <nCount> ] ] ] )
.in 1.28i
\fB-> nMinlen
.sp
.in 0.08i
\fBArguments
.sp
.in 0.4i
\fB<aArray>\fR is the array containing the elements to be measured\.
.sp
\fB<nDimension>\fR is the array dimension to be measured,
.in 1.28i
defaults to first dimension\.
.sp
.in 0.4i
\fB<nStart>\fR is the starting array element to include,
.in 1.28i
defaults to first array element\.
.sp
.in 0.4i
\fB<nCount>\fR is the number of array elements to process from
.in 1.28i
from \fB<nStart>\fR, defaults to remaining elements
in array\.
.sp
.in 0.08i
\fBReturns
.sp
.in 0.4i
The length of the shortest size element of an array\.
.sp
.in 0.08i
\fBDescription
.sp
.in 0.4i
This function will measure each element of an array
dimension and return the shortest element\.
.sp
.in 0.08i
\fBExamples
.sp
.in 0.4i
.ta 2.08i
FT_AEMINLEN(aArray) // Measure the 1st dimension of an Array
.br
.ta
.sp
.ta 2.08i
FT_AEMINLEN(aArray,2) // Measure the 2nd dimension of an Array
.br
.ta
.sp
.ta 2.08i
FT_AEMINLEN(aArray,2,,9) // Measure Elements 1-9 of 2nd dimension
.br
.ta
.sp
FT_AEMINLEN(aArray,3,5,9) // Measure Elements 5-9 of 3rd dimension
.sp
.ta 2.08i
FT_AEMINLEN(aArray,3,5) // Measure Elements 5 to end of 3rd dimension
.br
.ta
.sp
.in 0.08i
\fBSource:\fR AEMINLEN\.PRG
.sp
.ta 1.84i
\fBAuthor:\fR Ralph Oliver, TRANSCOM SYSTEMS
.br
.ta
.in 0i
.sp
.in 1.5i
.ti -1.5i
.ta 1.5i
.ft B
See Also:
.ft R
FT_AEMAXLEN()
.ta 1.63265i
.in 0i
.sp 2
.ne 20
.ps +3
.vs +3
FT_AMEDIAN() Find middle value in array, or average of two middle values
.br
.ta
.in 0.08i
.ps -3
.vs -3
.sp 2
\fBFT_AMEDIAN()
Find middle value in array, or average of two middle values
.in 0i
.br
\l'6.24i'
.br
.sp
.in 0.08i